home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / eother__ / otd_206.zip / OTD.DOC < prev    next >
Text File  |  1996-01-30  |  43KB  |  1,443 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                       The Software Construction Co.
  8.  
  9.                               Presents ...
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                             On This Day (tm)
  21.                               Version 2.04
  22.                                July, 1995
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                             _______
  29.                        ____|__     |               (tm)
  30.                     --|       |    |-------------------
  31.                       |   ____|__  |  Association of
  32.                       |  |       |_|  Shareware
  33.                       |__|   o   |    Professionals
  34.                     -----|   |   | --------------------
  35.                          |___|___|    MEMBER
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                       The Software Construction Co
  42.                                PO Box 160
  43.                      North Billerica, MA  01862-0160
  44.                       (508) 851-6204 (voice or FAX)
  45.                              CIS: 70313,3615
  46.                     Internet: softcons@world.std.com
  47.  
  48.  
  49.  
  50.  
  51.   (C) Copyright 1990-1995 The Software Construction Co., All Rights Reserved.
  52.  
  53.          1. Introduction                                             1
  54.          2. Command Line                                             2
  55.          3. Databases                                                4
  56.          4. Database format                                          7
  57.          5. Date specifiers                                          8
  58.          6. Notes about calendars                                   10
  59.          7. User Supported Software                                 12
  60.          8. Bug Reports                                             15
  61.          9. Known Problems/Limitations                              16
  62.          Appendices                                                 17
  63.              A. Bibliography                                        17
  64.              B. Program History                                     18
  65.          On This Day                                      Version 2.04
  66.  
  67.          1. Introduction
  68.  
  69.          Have you ever been curious about events that happened on this
  70.          day in history?  On This Day is a collection of databases and
  71.          a printing interface which will generate a list of items of
  72.          note concerning today.  The databases sent to registered
  73.          users contain more than 17,000 entries (see section 7 for
  74.          more information about registration).
  75.  
  76.          Some of the types of information which may be displayed are:
  77.  
  78.                    - Astronomical events.
  79.  
  80.                    - Birthdays of famous people.
  81.  
  82.                    - Historical events.
  83.  
  84.                    - National observations.
  85.  
  86.                    - Religious holidays and events.
  87.  
  88.          In addition, a personal database may be created to contain
  89.          events important to each specific user.  Events such as
  90.          birthdays of relatives and friends may be appropriate for
  91.          this file.
  92.  
  93.          To clarify, the question this software is intending to answer
  94.          is:
  95.  
  96.          What historical events, religious holidays, etc. happened on
  97.          a particular date?
  98.  
  99.          It is not intended to answer questions like:
  100.  
  101.          What date is Easter next year?
  102.          When was John Wayne born?
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                        1 
  125.          On This Day                                      Version 2.04
  126.  
  127.          2. Command Line
  128.  
  129.          To run On This Day, use the following command line (note that
  130.          []s enclose optional arguments):
  131.  
  132.                    OTD [-b] [-e] [-p] [-r] [-d <date>]
  133.                        [-m <day-number>|all]
  134.  
  135.                    where:
  136.  
  137.                              b  prints famous birthdays
  138.  
  139.                              d  allows you to specify a date other
  140.                                 than today's date.  Date may be ANY
  141.                                 form specified in section 5, below.
  142.                                 Some may not make sense in actual use
  143.                                 (e.g. R(*) would only print stuff on
  144.                                 Thursdays.)  Note also that only items
  145.                                 that occurred before the date
  146.                                 specified will be printed.
  147.  
  148.                              e  prints today's events
  149.  
  150.                              p  prints today's personal events
  151.  
  152.                              r  prints today's religious events
  153.  
  154.                              m  indicates when to print monthly events
  155.                                 (<day-number> indicates the day each
  156.                                 month.  all indicates to print every
  157.                                 day.) (default: 1)  For example, the
  158.                                 command:  'otd -m 3' will print
  159.                                 today's events and if today is the
  160.                                 third day of the month, it will also
  161.                                 print any existing monthly events. For
  162.                                 more information on monthly events,
  163.                                 see section 5.
  164.  
  165.          Again, we must emphasize that it is NOT necessary to input
  166.          ANY arguments to the OTD command.  Simply typing "OTD"
  167.          (without the quotes, of course) will get you all the output
  168.          in the format that we believe most users want.  If you want
  169.          to alter the output in any way, use the options as described
  170.          above.
  171.  
  172.          Running OTD with none of the b, e, p, or r options is the
  173.          same as running with all the options.  If any of these
  174.          options are specified, only those categories will be
  175.          displayed.
  176.  
  177.          DOS hints:
  178.  
  179.          Q:     How can I print the output of OTD?
  180.  
  181.          A:     Append '> PRN:' to your command line (e.g. OTD > PRN:
  182.                 will send today's information to the printer).
  183.  
  184.                                        2 
  185.          On This Day                                      Version 2.04
  186.  
  187.          Q:     It all goes by so quickly ... How do I get it to slow
  188.                 down so I can read it all?
  189.  
  190.          A:     Append '| MORE' to your command line (e.g. OTD | MORE
  191.                 will run OTD, displaying the results one screen at a
  192.                 time).  For more information on the MORE filter, see
  193.                 your DOS manual.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.                                        3 
  245.          On This Day                                      Version 2.04
  246.  
  247.          3. Databases
  248.  
  249.          On This Day reads it's data from a subset of the following
  250.          databases:
  251.  
  252.  
  253.                    BIRTHDAY.JAN         EVENTS.JAN
  254.                    BIRTHDAY.FEB         EVENTS.FEB
  255.                    BIRTHDAY.MAR         EVENTS.MAR
  256.                    BIRTHDAY.APR         EVENTS.APR
  257.                    BIRTHDAY.MAY         EVENTS.MAY
  258.                    BIRTHDAY.JUN         EVENTS.JUN
  259.                    BIRTHDAY.JUL         EVENTS.JUL
  260.                    BIRTHDAY.AUG         EVENTS.AUG
  261.                    BIRTHDAY.SEP         EVENTS.SEP
  262.                    BIRTHDAY.OCT         EVENTS.OCT
  263.                    BIRTHDAY.NOV         EVENTS.NOV
  264.                    BIRTHDAY.DEC         EVENTS.DEC
  265.                    RELIGION             EVENTS.OTH
  266.                    PERSONAL
  267.  
  268.          Files in the current directory by these names will be used
  269.          first.  If they do not exist there, the directory specified
  270.          in the OTDDIR entry in the OTD.INI file will be searched.
  271.          This entry was created or updated when you installed On This
  272.          Day.
  273.  
  274.          The easiest way to update this value is to reinstall On This
  275.          Day.  If you have simply moved the directory in which you
  276.          originally installed On This Day, however, you can use your
  277.          favorite text editor (a small one comes on the installation
  278.          diskettes if you don't already have an editor) to alter the
  279.          line that looks like:
  280.  
  281.          otddir=<some directory name>
  282.  
  283.          Change the value to the right of the =, (<some directory
  284.          name>) in the above example to be the directory in which the
  285.          data files now reside.
  286.  
  287.          If the -d option has not been specified, the current date
  288.          from the system clock is used it to determine the extension
  289.          to use in the BIRTHDAY and EVENTS files.
  290.  
  291.          If you set the TZ environment variable, OTD will use that
  292.          value when printing times for astronomical events.  The
  293.          syntax of the TZ environment variable is:
  294.  
  295.          SET TZ=zzz[+/-]d[d][lll]
  296.  
  297.          zzz is a three character field representing the name of the
  298.          current time zone (e.g. EST, PST).
  299.  
  300.          [+/-]d[d] is an optionally signed number of one or more
  301.          digits.  It is the local time zone's difference from GMT in
  302.          hours.  Negative numbers adjust westward from GMT. (e.g.
  303.  
  304.                                        4 
  305.          On This Day                                      Version 2.04
  306.  
  307.          5=EST, +8=PST, and -1=continental Europe).
  308.  
  309.          lll is an optional three-character field that represents the
  310.          local time zone daylight savings time (e.g. EDT, PDT).  Don't
  311.          include this field if your time zone does not have daylight
  312.          savings time.
  313.  
  314.          If the TZ environment variable isn't present or is not of the
  315.          above form, a default value of EST5EDT will be used.
  316.  
  317.          If birthday information was requested, BIRTHDAY.<mon> will be
  318.          read.  If events were requested, EVENTS.<mon> and EVENTS.OTH
  319.          will be read.  EVENTS.OTH is used for those events which
  320.          might be in different months in different years.  If
  321.          religious events were requested, RELIGION will be read.  If
  322.          personal events were requested, PERSONAL will be read.
  323.  
  324.          The entries will be printed as they are encountered in each
  325.          database.  If you want entries printed in a specific order,
  326.          they must be in that order in the database.
  327.  
  328.          OTD is distributed with all the above databases with the
  329.          exception of PERSONAL.  Note, however, that much larger and
  330.          more extensive databases will be sent to you should you
  331.          register your copy (see section 7 for more information about
  332.          this and other advantages of registration).
  333.  
  334.          Some of the databases distributed with the program are
  335.          compressed.  This helps save disk space upon installation.
  336.          OTD determines dynamically whether a database is compressed
  337.          or not and reads it appropriately.  Upon registration, you
  338.          will also receive the compression and decompression programs
  339.          so that you may maintain the databases that we distribute.
  340.  
  341.          You may, of course, replace any of our compressed databases
  342.          with your own in order to try out some of the features of the
  343.          event specification language.  Or, you may try out
  344.          interesting features in your PERSONAL database without
  345.          touching any of our databases.  The program itself is not
  346.          crippled in any way.  You have the ability to test all
  347.          functionality it is capable of performing.
  348.  
  349.          Note that the information contained in the databases
  350.          distributed with the program has been taken from a great many
  351.          sources since sometime in 1985 or so.  We do not guarantee
  352.          their accuracy.  You may also find duplicate entries which
  353.          are not indicated in the database.  We would appreciate
  354.          hearing about these as we do try to weed out the duplicates
  355.          when and if we can find another source to collaborate one of
  356.          the dates.
  357.  
  358.          We are always interested in new dates.  If possible, please
  359.          try to give us supporting evidence of a new date.  We do not
  360.          want the databases to get any less reliable than they already
  361.          are.  In fact we want them to improve in reliability over
  362.          time.  We do, however, reserve the right not to add any date
  363.  
  364.                                        5 
  365.          On This Day                                      Version 2.04
  366.  
  367.          to the database.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.                                        6 
  425.          On This Day                                      Version 2.04
  426.  
  427.          4. Database format
  428.  
  429.          A line in the database file may be in one of the following
  430.          forms:
  431.  
  432.                    #:<stuff>
  433.  
  434.                         This line is ignored by OTD.  It is merely
  435.                         used to add commentary to the file.
  436.  
  437.                    <relative date specifier>:<stuff>
  438.  
  439.                         Should today match the relative date
  440.                         specifier, print the stuff to the standard
  441.                         output device.  See section 5 for more
  442.                         detailed information about date specifiers.
  443.  
  444.                    <blanks>:<stuff>
  445.  
  446.                         This type of line indicates a continuation of
  447.                         the line preceding for use when one line won't
  448.                         hold enough text.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.                                        7 
  485.          On This Day                                      Version 2.04
  486.  
  487.          5. Date specifiers
  488.  
  489.          Date specifiers may have one of the following forms:
  490.  
  491.          Absolute Dates -
  492.  
  493.                    <month-number>
  494.  
  495.                         If this month (in the specified calendar)
  496.                         matches <month-number> and the -m option
  497.                         specifies today as the print day, print the
  498.                         item.
  499.  
  500.                    <month-number>/<day>
  501.  
  502.                         If this month (in the specified calendar)
  503.                         matches <month-number> and this day matches
  504.                         <day>, print the item.
  505.  
  506.                    <month-number>/<day>/<year>
  507.  
  508.                         If this month (in the specified calendar)
  509.                         matches <month-number> and this day matches
  510.                         <day>, print the item with "In <year>,"
  511.                         prepended.
  512.  
  513.          Relative dates -
  514.  
  515.                    <alternate calendar><absolute date>
  516.  
  517.                         This form directs OTD to use the specified
  518.                         calendar to evaluate <absolute date>.  Valid
  519.                         <alternate calendar>s are:
  520.  
  521.                              G or <none> Gregorian
  522.                              H           Hebrew
  523.                              HF          Hebrew Fast Day
  524.                                          (will be moved to following
  525.                                           day if it is Saturday)
  526.                              I           Islamic
  527.                              J           Julian
  528.  
  529.                         See section 6 for short descriptions of these
  530.                         calendars.
  531.  
  532.                    <absolute date>+<days>
  533.  
  534.                         Add <days> to the date specified in <absolute
  535.                         date>.  For example, 1/3+37 is the same as
  536.                         2/9.
  537.  
  538.                    <absolute date>-<days>
  539.  
  540.                         Subtract <days> from the date specified in
  541.                         <absolute date>.  For example, 1/3-21 is the
  542.                         same as 12/13.
  543.  
  544.                                        8 
  545.          On This Day                                      Version 2.04
  546.  
  547.                    <wkday>(<month>/<day>)
  548.  
  549.                         This specifies the first <wkday> occurring on
  550.                         or before the date specified by <month> and
  551.                         <day>.  Valid values for <wkday> are:
  552.  
  553.                              M          Monday
  554.                              T          Tuesday
  555.                              W          Wednesday
  556.                              R          thuRsday
  557.                              F          Friday
  558.                              S          Saturday
  559.                              U          sUnday
  560.  
  561.                         For example, W(8/14) specifies the second
  562.                         Wednesday occurring in the month of August.
  563.  
  564.                    <wkday>(*)
  565.  
  566.                         This denotes every day that happens to fall on
  567.                         the specified <wkday>.  Valid values for
  568.                         <wkday> are:
  569.  
  570.                              M          Monday
  571.                              T          Tuesday
  572.                              W          Wednesday
  573.                              R          thuRsday
  574.                              F          Friday
  575.                              S          Saturday
  576.                              U          sUnday
  577.  
  578.                         For example, M(*) specifies every Monday.
  579.  
  580.                    E
  581.  
  582.                         This denotes the Christian holiday Easter.
  583.  
  584.                    E+<days>
  585.  
  586.                         This denotes a date <days> days following the
  587.                         Christian holiday Easter.  This format is
  588.                         necessary to specify all the Christian
  589.                         holidays as many are based upon Easter's date.
  590.  
  591.                    E-<days>
  592.  
  593.                         This denotes a date <days> days before the
  594.                         Christian holiday Easter.  This format is
  595.                         necessary to specify all the Christian
  596.                         holidays as many are based upon Easter's date.
  597.  
  598.                    *
  599.  
  600.                         This denotes every day.
  601.  
  602.  
  603.  
  604.                                        9 
  605.          On This Day                                      Version 2.04
  606.  
  607.          6. Notes about calendars
  608.  
  609.          Gregorian calendar
  610.  
  611.                 This calendar is the one in use currently by much of
  612.                 the world (including the United States).  It was
  613.                 designed by a commission assembled by Pope Gregory
  614.                 XIII in the sixteenth century.  It is based on the
  615.                 revolution of the earth about the sun.
  616.  
  617.                 The months and corresponding numbers that are legal
  618.                 for this calendar are:
  619.  
  620.                 January         1
  621.                 February        2
  622.                 March           3
  623.                 April           4
  624.                 May             5
  625.                 June            6
  626.                 July            7
  627.                 August          8
  628.                 September       9
  629.                 October         10
  630.                 November        11
  631.                 December        12
  632.  
  633.          Hebrew calendar
  634.  
  635.                 This calendar was placed in operation in the mid-
  636.                 fourth century by Hillel II.  It is based on the
  637.                 moon's revolution about the earth.  However, it has
  638.                 solar corrections built in.
  639.  
  640.                 The months and corresponding numbers that are legal
  641.                 for this calendar are:
  642.  
  643.                 Nisan   1
  644.                 Iyyar   2
  645.                 Sivan   3
  646.                 Tammuz  4
  647.                 Av      5
  648.                 Elul    6
  649.                 Tishri  7
  650.                 Heshvan 8
  651.                 Kislev  9
  652.                 Teveth  10
  653.                 Shevat  11
  654.                 Adar    12
  655.                 Adar II 13 {Note Adar is Adar I in years when
  656.                             there is an Adar II}
  657.  
  658.                 Certain holidays (fast days) must be moved to the
  659.                 following day (Sunday) if they fall on a Saturday.
  660.                 The HF calendar specifier allows you to indicate a
  661.                 Hebrew date is one of these "special" holidays.
  662.  
  663.  
  664.                                       10 
  665.          On This Day                                      Version 2.04
  666.  
  667.                 Note that one holiday (Ta'anit Esther) occurs on the
  668.                 preceding Thursday when Purim is on a Sunday.  There
  669.                 is no way, currently, to specify this relationship.
  670.  
  671.          Islamic calendar
  672.  
  673.                 This calendar is based upon the moon revolving around
  674.                 the earth.  There are no dates in this calendar before
  675.                 Friday, July 16, 622 (Julian)
  676.  
  677.                 Much of the Islamic world does not agree with
  678.                 calculations to determine this calendar at all.  They
  679.                 only rely on proclamation of the new moon by the
  680.                 authorities at al-Azhar in Cairo to define the
  681.                 calendar.  Consequently, the dates computed here may
  682.                 differ by a day or two from those observed by much of
  683.                 the Islamic population of the world.
  684.  
  685.                 The months and corresponding numbers that are legal
  686.                 for this calendar are:
  687.  
  688.                 Muharram        1
  689.                 Safar           2
  690.                 Rabi I          3
  691.                 Rabi II         4
  692.                 Jumada I        5
  693.                 Jumada II       6
  694.                 Rajab           7
  695.                 Sha'ban         8
  696.                 Ramadan         9
  697.                 Shawwal         10
  698.                 Dhu al-Qada     11
  699.                 Dhu al-Hijjah   12
  700.  
  701.          Julian calendar
  702.  
  703.                 This calendar was instituted in 45 BC by Julius
  704.                 Caesar.  It, too, is based on the revolution of the
  705.                 earth about the sun.
  706.  
  707.                 The months for the Julian calendar are the same as
  708.                 those used for the Gregorian calendar.  See above for
  709.                 more information on the proper month numbers to use
  710.                 when constructing dates.
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.                                       11 
  725.          On This Day                                      Version 2.04
  726.  
  727.          7. User Supported Software
  728.  
  729.          This program is produced by a member of the Association of
  730.          Shareware Professionals (ASP).  ASP wants to make sure that
  731.          the shareware principle works for you.  If you are unable to
  732.          resolve a shareware-related problem with an ASP member by
  733.          contacting the member directly, ASP may be able to help.  The
  734.          ASP Ombudsman can help you resolve a dispute or problem with
  735.          an ASP member, but does not provide technical support for
  736.          members' products.  Please write to the ASP Ombudsman at 545
  737.          Grover Road, Muskegon, MI  49442 or send a CompuServe message
  738.          via CompuServe Mail to ASP Ombudsman 70007,3536.
  739.  
  740.          DEFINITION OF SHAREWARE
  741.  
  742.          Shareware distribution gives users a chance to try software
  743.          before buying it.  If you try a Shareware program and
  744.          continue using it, you are expected to register.  Individual
  745.          programs differ on details -- some request registration while
  746.          others require it, some specify a maximum trial period.  With
  747.          registration, you get anything from the simple right to
  748.          continue using the software to an updated program with
  749.          printed manual.
  750.  
  751.          Copyright laws apply to both Shareware and commercial
  752.          software, and the copyright holder retains all rights, with a
  753.          few specific exceptions as stated below.  Shareware authors
  754.          are accomplished programmers, just like commercial authors,
  755.          and the programs are of comparable quality.  (In both cases,
  756.          there are good programs and bad ones!)  The main difference
  757.          is in the method of distribution.  The author specifically
  758.          grants the right to copy and distribute the software, either
  759.          to all and sundry or to a specific group.  For example, some
  760.          authors require written permission before a commercial disk
  761.          vendor may copy their Shareware.
  762.  
  763.          Shareware is a distribution method, not a type of software.
  764.          You should find software that suits your needs and
  765.          pocketbook, whether it's commercial or Shareware.  The
  766.          Shareware system makes fitting your needs easier, because you
  767.          can try before you buy.  And because the overhead is low,
  768.          prices are low also.  Shareware has the ultimate money-back
  769.          guarantee -- if you don't use the product, you don't pay for
  770.          it.
  771.  
  772.          DISCLAIMER - AGREEMENT
  773.  
  774.          Users of On This Day must accept this disclaimer of warranty:
  775.          "On This Day is supplied as is.  The author disclaims all
  776.          warranties, expressed or implied, including, without
  777.          limitation, the warranties of merchantability and of fitness
  778.          for any purpose.  The author assumes no liability for
  779.          damages, direct or consequential, which may result from the
  780.          use of On This Day."
  781.  
  782.  
  783.  
  784.                                       12 
  785.          On This Day                                      Version 2.04
  786.  
  787.          On This Day is a "shareware program" and is provided at no
  788.          charge to the user for evaluation.  Feel free to share it
  789.          with your friends, but please do not give it away altered or
  790.          as part of another system.  The essence of "user-supported"
  791.          software is to provide personal computer users with quality
  792.          software without high prices, and yet to provide incentive
  793.          for programmers to continue to develop new products.  If you
  794.          find this program useful and find that you are using On This
  795.          Day and continue to use On This Day after a reasonable trial
  796.          period, you must make a registration payment of $30.00 (US
  797.          funds) to The Software Construction Co.  The $30.00
  798.          registration fee will license one copy for use on any one
  799.          computer at any one time.  You must treat this software just
  800.          like a book.  An example is that this software may be used by
  801.          any number of people and may be freely moved from one
  802.          computer location to another, so long as there is no
  803.          possibility of it being used at one location while it's being
  804.          used at another.  Just as a book cannot be read by two
  805.          different persons at the same time.
  806.  
  807.          Commercial users of On This Day must register and pay for
  808.          their copies of On This Day within 30 days of first use or
  809.          their license is withdrawn.  Site-License arrangements may be
  810.          made by contacting The Software Construction Co.
  811.  
  812.          Anyone distributing On This Day for any kind of remuneration
  813.          must first contact The Software Construction Co. via one of
  814.          the means below for authorization.  This authorization will
  815.          be automatically granted to distributors recognized by the
  816.          (ASP) as adhering to its guidelines for shareware
  817.          distributors, and such distributors may begin offering On
  818.          This Day immediately (However The Software Construction Co.
  819.          must still be advised so that the distributor can be kept up-
  820.          to-date with the latest version of On This Day.).
  821.  
  822.          You are encouraged to pass a copy of On This Day along to
  823.          your friends for evaluation.  Please encourage them to
  824.          register their copy if they find that they can use it.  All
  825.          registered users will receive a copy of the latest version of
  826.          On This Day.
  827.  
  828.          If you have received this software through one of the so
  829.          called "Shareware Houses" (companies whose business is
  830.          selling disks containing other author's software), please
  831.          note that none of the money you have paid so far has (or
  832.          will) make its way to the author.  You have simply paid for
  833.          the duplication and distribution costs.
  834.  
  835.          Registration benefits include:
  836.  
  837.                    - Notification of any updates.
  838.  
  839.                    - The latest version of the software.
  840.  
  841.  
  842.  
  843.  
  844.                                       13 
  845.          On This Day                                      Version 2.04
  846.  
  847.                    - The very next version of the software.
  848.  
  849.                    - A much more extensive collection of data.
  850.  
  851.                    - The compression and decompression programs.
  852.  
  853.                    - Several other utilities which make the
  854.                      maintenance of the databases much easier.
  855.  
  856.                    - A quotation database and program.
  857.  
  858.          Although we encourage copying and sharing of On This Day to
  859.          distribute our product, we must insist that you NOT share the
  860.          utilities, compression/decompression programs, and larger
  861.          databases you will receive upon registration.  We retain full
  862.          copyrights to these files.  It is an infringement of
  863.          copyright law to distribute copies of these files.
  864.  
  865.          To make it easier for registered users to share copies of On
  866.          This Day with their friends we have included a utility
  867.          (OTDSHARE.BAT) on the registered version of the disk.  This
  868.          utility will create a "shareable" disk.  Please see the
  869.          read.me file on your registered disk for more information.
  870.  
  871.          Please contact us at:
  872.  
  873.                           The Software Construction Co.
  874.                                  P.O. Box 160
  875.                            North Billerica, MA   01862
  876.  
  877.          Or, you may send a message via CompuServe Mail: 70313,3615
  878.  
  879.          Or, you may send a message via Internet email:
  880.          softcons@world.std.com
  881.  
  882.          Or you may call us at (508) 851-6204.  This number can accept
  883.          voice or FAX calls 24 hours a day.
  884.  
  885.          If you do not use this software, we'd also like to know why.
  886.          It is obvious you're somewhat interested or you wouldn't have
  887.          gotten this far into the manual.  We'd like to know how we
  888.          can make this product better.  Please contact us using the
  889.          same means listed above and let us know what we could have
  890.          done to make them useful to you.
  891.  
  892.          For $5 to cover the cost of the diskette(s) and shipping
  893.          (refunded when you register), we will supply you with the
  894.          latest edition of the software.  Please specify if you'd like
  895.          5.25" or 3.5" diskettes.
  896.  
  897.          We would sincerely like to thank you for giving this, the
  898.          fruits of our labor, a trial.  We hope it proves useful to
  899.          you.
  900.  
  901.  
  902.  
  903.  
  904.                                       14 
  905.          On This Day                                      Version 2.04
  906.  
  907.          8. Bug Reports
  908.  
  909.          Should you discover a bug in this code, please let us know
  910.          using one of the mechanisms listed in section 7.  Provide us
  911.          with as much of a description of the problem as you can, as
  912.          well as your name and address.  If you would prefer being
  913.          contacted by phone, by all means, add your phone number and
  914.          the hours you will be available at that number.
  915.  
  916.          What do you get for your trouble?  We will send a copy of the
  917.          fixed program to the first registered user to report the
  918.          problem and will strive to answer all others with a letter.
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.                                       15 
  965.          On This Day                                      Version 2.04
  966.  
  967.          9. Known Problems/Limitations
  968.  
  969.          a.     The Jewish holiday Ta'anit Esther occurs on the
  970.                 preceding Thursday when Purim falls on Sunday.  There
  971.                 is no way, currently, to indicate this relationship.
  972.                 We are not sure that this functionality will ever be
  973.                 included as this relationship is extraordinarily rare.
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.                                       16 
  1025.          On This Day                                      Version 2.04
  1026.  
  1027.          A. Bibliography
  1028.  
  1029.          Special thanks to John Peyton, a friend who helped get me
  1030.          thinking along the right path several times.
  1031.  
  1032.          Following is a list (no doubt partial) of items I found
  1033.          helpful when learning how to calculate the various calendars,
  1034.          astronomical events, etc. that are contained in the software:
  1035.  
  1036.          Astronomical Formulae for Calculators by Jean Meeus, 1982,
  1037.                 Willmann-Bell, Inc.
  1038.  
  1039.          Calendrical Calculations by Edward M. Reingold and Nachum
  1040.                 Dershowitz, 1989, University of Illinois at Urbana-
  1041.                 Champaign.
  1042.  
  1043.          Practical Astronomy With Your Calculator by Peter Duffett-
  1044.                 Smith, 3rd edition 1988, Cambridge University Press.
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.                                       17 
  1085.          On This Day                                      Version 2.04
  1086.  
  1087.          B. Program History
  1088.  
  1089.          Version 1.0 - April 1990.
  1090.  
  1091.          Version 1.1 - July 1991.
  1092.  
  1093.                 - Phases of the moon added.
  1094.  
  1095.                 - Lunar eclipses added.
  1096.  
  1097.                 - Compression for databases.
  1098.  
  1099.                 - Serial numbers to track distribution better.
  1100.  
  1101.                 - TZ environment variable controls times for
  1102.                   astronomical events.
  1103.  
  1104.                 - A few minor bug fixes.
  1105.  
  1106.                 - CompuServe support offered.
  1107.  
  1108.                 - New installation utility.
  1109.  
  1110.          Version 1.2 - October 1992.
  1111.  
  1112.                 - Registrations accepted by PsL and BUDGETWARE.
  1113.  
  1114.                 - GEnie support offered.
  1115.  
  1116.          Version 1.3 - October 1992.
  1117.  
  1118.                 - Database update.
  1119.  
  1120.          Version 1.4 - January 1993.
  1121.  
  1122.                 - Database update.
  1123.  
  1124.                 - Minor bugfixes.
  1125.  
  1126.                 - Quotation database added as registration incentive.
  1127.  
  1128.  
  1129.          Version 1.5 - May 1993.
  1130.  
  1131.                 - Database update.
  1132.  
  1133.          Version 1.6 - August 1993.
  1134.  
  1135.                 - Database update.
  1136.  
  1137.          Version 1.7 - October 1993.
  1138.  
  1139.                 - Database update.
  1140.  
  1141.  
  1142.  
  1143.  
  1144.                                       18 
  1145.          On This Day                                      Version 2.04
  1146.  
  1147.                 - Weekday printed with Gregorian date.
  1148.  
  1149.                 - dd.mm.yy dateform.
  1150.  
  1151.                 - Easter offset bug (for years other than current)
  1152.                   fixed.
  1153.  
  1154.                 - Continuation lines indented slightly (as in versions
  1155.                   prior to 1.4).
  1156.  
  1157.                 - Day number and number of days remaining printed with
  1158.                   Gregorian calendar.
  1159.  
  1160.  
  1161.          Version 1.8 - January 1994.
  1162.  
  1163.                 - Database update.
  1164.  
  1165.  
  1166.          Version 1.9 - April 1994.
  1167.  
  1168.                 - Database update.
  1169.  
  1170.                 - Problem with installation program not finding AUTOEXEC.BAT
  1171.                   in some rare cases fixed.
  1172.  
  1173.                 - Blank lines in database files are treated as comments.
  1174.  
  1175.                 - Dates before Islamic calendar no longer cause an invalid
  1176.                   date to be displayed.
  1177.  
  1178.          Version 2.0 - July 1994.
  1179.  
  1180.                 - Database update.
  1181.  
  1182.                 - Comments interspersed with continuation lines now
  1183.                   cause the rest of the continuation lines to be
  1184.                   ignored.  This was necessary to support leap years
  1185.                   adequately.
  1186.  
  1187.                 - * now truly means every day, not just today.  That
  1188.                   is, an event tagged * will be displayed every day
  1189.                   not just when displaying the same date as the
  1190.                   system clock.
  1191.  
  1192.          Version 2.01 - October 1994.
  1193.  
  1194.                 - Database update.
  1195.  
  1196.                 - Added diagnostic utility.
  1197.  
  1198.          Version 2.02 - January 1995.
  1199.  
  1200.                 - Database update.
  1201.  
  1202.  
  1203.  
  1204.                                       19 
  1205.          On This Day                                      Version 2.04
  1206.  
  1207.                 - Data file search changed from using an environment
  1208.                 variable to using an .ini file entry.
  1209.  
  1210.          Version 2.03 - April 1995.
  1211.  
  1212.                 - Database update.
  1213.  
  1214.                 - Longer lines in databases now handled more
  1215.                 gracefully.
  1216.  
  1217.                 - new -a option to avoid doing astronomical
  1218.                 calculations.
  1219.  
  1220.                 - new -c option to avoid output of the date block at
  1221.                 the top of the output.
  1222.  
  1223.          Version 2.04 - July 1995.
  1224.  
  1225.                 - Database update.
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.                                       20 
  1265.  
  1266.    - A -
  1267.  
  1268.          absolute dates                 <see dates, absolute>
  1269.          address, CompuServe            14
  1270.          address, Internet              14
  1271.          address, US Mail               14
  1272.          agreement                      12
  1273.          alternate date specification   2
  1274.          ASP Ombudsman                  12
  1275.          Assoc. of Shareware Prof.      12
  1276.          astronomical events            <see events, astronomical>
  1277.  
  1278.    - B -
  1279.  
  1280.          birthdays                      1, 2, 5
  1281.          bugs                           15
  1282.  
  1283.    - C -
  1284.  
  1285.          calendar, Gregorian            8, 10
  1286.          calendar, Hebrew               8, 10
  1287.          calendar, Islamic              8, 11
  1288.          calendar, Julian               8, 11
  1289.          calendars                      10
  1290.          command line                   2
  1291.          command line options           2
  1292.          comments                       7
  1293.          compression                    5
  1294.          continuation lines             7
  1295.  
  1296.    - D -
  1297.  
  1298.          database format                7
  1299.          databases                      4
  1300.          date specifiers                8
  1301.          dates, absolute                8
  1302.          dates, relative                8
  1303.          decompression                  5
  1304.          disclaimer                     12
  1305.  
  1306.    - E -
  1307.  
  1308.          Easter                         9
  1309.          events                         2, 5
  1310.          events, astronomical           1
  1311.          events, historical             1
  1312.          events, monthly                2
  1313.          events, personal               2, 5
  1314.          events, religious              1, 2, 5
  1315.  
  1316.    - F -
  1317.  
  1318.          FAX number                     14
  1319.  
  1320.    - G -
  1321.  
  1322.          Gregorian calendar             <see calendar, Gregorian>
  1323.  
  1324.    - H -
  1325.          Hebrew calendar                <see calendar, Hebrew>
  1326.          Hillel II                      10
  1327.          historical events              <see events, historical>
  1328.  
  1329.    - I -
  1330.  
  1331.          introduction                   1
  1332.          Islamic calendar               <see calendar, Islamic>
  1333.  
  1334.    - J -
  1335.  
  1336.          Julian calendar                <see calendar, Julian>
  1337.          Julius Caesar                  11
  1338.  
  1339.    - L -
  1340.  
  1341.          limitations                    16
  1342.  
  1343.    - M -
  1344.  
  1345.          monthly events                 <see events, monthly>
  1346.  
  1347.    - N -
  1348.  
  1349.          national observances           1
  1350.  
  1351.    - O -
  1352.  
  1353.          options, command line          <see command line options>
  1354.          OTDDIR entry in .ini file      4
  1355.  
  1356.    - P -
  1357.  
  1358.          PATH environment variable      4
  1359.          personal events                <see events, personal>
  1360.          phone number                   14
  1361.          Pope Gregory XIII              10
  1362.          problems                       15
  1363.          problems, known                16
  1364.  
  1365.    - R -
  1366.  
  1367.          registration information       5
  1368.          relative dates                 <see dates, relative>
  1369.          religious events               <see events, religious>
  1370.          religious holidays             <see events, religious>
  1371.          reporting bugs                 15
  1372.  
  1373.    - S -
  1374.  
  1375.          shareware                      12
  1376.  
  1377.    - T -
  1378.  
  1379.          time zone                      <see TZ environment variable>
  1380.          TZ environment variable        4
  1381.  
  1382.    - U -
  1383.  
  1384.          user supported software        <see shareware>
  1385.    - Misc -
  1386.  
  1387.          -m option                      8
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.                           The Software Construction Co
  1399.                                    PO Box 160
  1400.                          North Billerica, MA  01862-0160
  1401.                      (508) 851-6204 (voice or FAX, 24 hours)
  1402.                                  CIS: 70313,3615
  1403.                         Internet: softcons@world.std.com
  1404.  
  1405.         We can accept Visa or Mastercard as well as checks and money
  1406.         orders ...
  1407.  
  1408.         Credit Card Number ________________________  Expires ____________
  1409.  
  1410.         Name:    ________________________________________________________
  1411.  
  1412.         Address: ________________________________________________________
  1413.  
  1414.                  ________________________________________________________
  1415.  
  1416.                  ________________________________________________________
  1417.  
  1418.         Phone:   ________________________________________________________
  1419.  
  1420.         Where did you get your copy of On This Day (version 2.04)?
  1421.  
  1422.         The Software Construction Co. _____        BBS              _____
  1423.  
  1424.         Friend                        _____        Shareware Dealer _____
  1425.  
  1426.         If you checked BBS or Shareware Dealer above please tell us which
  1427.         one:
  1428.  
  1429.         _________________________________________________________________
  1430.  
  1431.         What format media would you like?         5.25" _____  3.5" _____
  1432.  
  1433.         Comments or suggestions: ________________________________________
  1434.  
  1435.         _________________________________________________________________
  1436.  
  1437.         _________________________________________________________________
  1438.  
  1439.         _________________________________________________________________
  1440.  
  1441.         _________________________________________________________________
  1442.  
  1443.